Команды прямого форматирования [Inline Markup Commands]
Внутри абзаца с обычным текстом действуют несколько команд разметки, задающие вид текста в выходном формате. Все они начинаются с заглавной буквы, далее следует аргумент, заключенный в угловые скобки: LETTER<argument>. Аргумент может состоять из нескольких слов и занимать более одной строки.
I<argument>
Аргумент выводится курсивом. I соответствует HTML-тэгамem и var, что обычно используется для выделения слов или обозначения переменных.
Примеры:
Не стоит удалять с машины ядро Linux!
образуется из такой строки:
I<Не стоит> удалять с машины ядро Linux!
Сменить рабочую директорию на directory можно командой cd directory.
порождается
Сменить рабочую директорию на I<directory> можно командой B<cd> I<directory>.
B<argument>
Аргумент выводится жирным шрифтом. B соответствует тэгу HTML b. Используется для выделения текста, названий программ и ключей командной строки.
Примеры:
Всегда выполняйте команду shutdown перед тем, как отключить питание.
является результатом
B<Всегда> выполняйте команду shutdown перед тем, как отключить питание.
podchecker допускает опции -warnings и -nowarnings.
появляется из
B<podchecker> допускает опции B<-warnings> и B<-nowarnings>.
C<argument>
C обозначает код или другой текст, который надо изобразить, как есть, буквально. Соответствует тэгам HTML code, samp, и tt.
Примеры:
Каждая C-программа должна содержать функцию по имени main.
порождается
Каждая C-программа должна содержать функцию по имени C<main>.
Логическое значение ЛОЖЬ представляется [1 1 0], а логическая ИСТИНА -- [1 1 1].
порождается
Логическое значение ЛОЖЬ представляется C<[1 1 0]>, а логическая ИСТИНА -- C<[1 1 1]>.
L<reference> or L<description|reference>
Создает ссылку на существующий reference. Если часть description опущена, то видимым текстом ссылки будет reference, в противном случае это будет description. Команда L отдаленно напоминает гиперссылку HTML <a href="reference">description</a>, но в POD reference не является унифицированным локатором ресурса (URL).
reference может ссылаться только на сгенерированные метки [labels], которые автоматически создаются трансляторами POD-во-что-то-другое. Такие метки создаются для каждой команды =head и =item. Метка, связанная с командой =head heading будет образована из переведенного в нижний регистр heading, других изменений в heading не делается. А именно, заголовку:
=head1 Заголовок из Нескольких Слов (ЗНС)
будет автоматически сопоставлена метка
заголовок из нескольких слов (знс)
К меткам для =item'ов добавляется префикс item_, пробелы заменяются символами подчеркивания, а не-буквы и не-цифры заменяются на знак процента, за которым следует их шестнадцатеричный ASCII-код. А вы ожидали преобразования попроще? Так, если бы при подготовке данной статьи один из пунктов был бы обозначен, как
=item Автоматическая Генерация Ссылок.
то он получил бы метку
item_Автоматическая_Генерация_Ссылок%2e
поскольку ASCII-код точки равен 46 или 2e в шестнадцатеричном формате.
Пример:
Исходный текст
=head1 Введение
В разделе L<"Концепции"> излагаются основы.
=head1 Концепции
...
=head1 Синхронизация
=over 4
=item Блокировки
=item Race Conditions
=item Разрешение блокировок
=back
То, как справляться с блокировками уже обсуждалось в L<разделе Блокировки|"item_Блокировки"> и L<Разрешение блокировок|"item_Разрешение_блокировок">.
Результат
